Skip to content

feat(status): display runtime invocation URL for deployed agents#775

Merged
aidandaly24 merged 1 commit intoaws:mainfrom
aidandaly24:feat/status-invocation-url
Apr 6, 2026
Merged

feat(status): display runtime invocation URL for deployed agents#775
aidandaly24 merged 1 commit intoaws:mainfrom
aidandaly24:feat/status-invocation-url

Conversation

@aidandaly24
Copy link
Copy Markdown
Contributor

Description

Show the runtime invocation URL in agentcore status output for each deployed agent. The URL is computed from the runtime ARN and target region using encodeURIComponent, and displayed across all three output surfaces:

  • CLI text output: URL: line below each deployed agent entry
  • CLI JSON output: invocationUrl field in resource entries (for scripting)
  • TUI ResourceGraph: URL: line below the ID: line, dimColor styled

URL format: https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{encodedArn}/invocations

The URL is computed before the live runtime status API call, so it is available even when the status fetch fails. It is only set for deployed agents with a known runtimeArn — local-only and pending-removal agents show no URL.

Changes

  • status/constants.ts: Added buildRuntimeInvocationUrl(region, runtimeArn) helper
  • status/action.ts: Added invocationUrl field to ResourceStatusEntry, computed during agent enrichment
  • status/command.tsx: CLI text rendering of URL below deployed agents
  • ResourceGraph.tsx: TUI rendering of URL via ResourceRow component

Related Issue

Closes #716

Documentation PR

N/A — no doc changes needed; the URL is self-documenting in the CLI output.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update
  • Other (please describe):

Testing

How have you tested the change?

  • I ran npm run test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional Testing

  • Unit tests: 6 new tests added (34 total), all passing
    • buildRuntimeInvocationUrl — correct URL with encoded ARN
    • buildRuntimeInvocationUrl — handles different regions
    • handleProjectStatus — sets invocationUrl on deployed agents
    • handleProjectStatus — does not set invocationUrl on local-only agents
    • handleProjectStatus — still sets invocationUrl when runtime status fetch fails
    • handleProjectStatus — does not set invocationUrl on pending-removal agents
  • Live AWS deployment: Deployed to us-east-1, ran agentcore status — URL displayed correctly
  • Live invoke: Agent responded successfully at the displayed endpoint (HTTP 200)
  • TUI harness: Launched interactive TUI, navigated to status screen — URL rendered below ID line
  • JSON output: agentcore status --json includes invocationUrl field

Checklist

  • I have read the CONTRIBUTING document
  • I have added any necessary tests that prove my fix is effective or my feature works
  • I have updated the documentation accordingly
  • I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the
terms of your choice.

Show the runtime invocation URL in agentcore status output for each
deployed agent. The URL is computed from the runtime ARN and target
region, and displayed in CLI text output, JSON output, and the TUI
ResourceGraph component.

URL format: https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{encodedArn}/invocations

Closes aws#716

Constraint: URL is only available when both targetConfig and runtimeArn exist
Rejected: Reuse existing buildInvokeUrl from agentcore.ts | includes ?qualifier=DEFAULT which is for API invocation, not display
Confidence: high
Scope-risk: narrow
@aidandaly24 aidandaly24 requested a review from a team April 6, 2026 17:15
@github-actions github-actions bot added the size/m PR size: M label Apr 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

Package Tarball

aws-agentcore-0.6.0.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-775-tarball/aws-agentcore-0.6.0.tgz

Copy link
Copy Markdown
Contributor

@jesseturner21 jesseturner21 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm. One question about entry.identifier but it doesnt even have to do with this pr

@aidandaly24 aidandaly24 merged commit 0aa9d55 into aws:main Apr 6, 2026
22 checks passed
@aidandaly24 aidandaly24 deleted the feat/status-invocation-url branch April 6, 2026 20:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/m PR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

agentcore status command include runtime invocation url for runtime status

2 participants